home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / database / arv134e.zip / COMPFLS.DOK < prev    next >
Text File  |  1994-12-05  |  4KB  |  93 lines

  1.  
  2.  
  3.  
  4.  
  5.              ┌───────────────────────────────────────────┐
  6.              │                                           │
  7.              │                                           │
  8.              │                 CompFLS                   │
  9.              │                                           │
  10.              │            File list compiler             │
  11.              │                                           │
  12.              │             for ARV & AFXREQ              │
  13.              │                                           │
  14.              │               Version 1.34                │
  15.              │                                           │
  16.              │                                           │
  17.              │                                           │
  18.              └───────────────────────────────────────────┘
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26. CompFLS will convert a file list in files.bbs style (i.e. a text file
  27. with each line consisting of a file name at the beginning, with a comment
  28. following later on) to an .AFX file.
  29.  
  30. COMPFLS may operate in batch mode; therefore it has the ability to
  31. guess the number of hashing table entries for fast lookup as well as
  32. the starting position of the file comments within the description lines.
  33.  
  34. You may use wildcards in the file spec, too, thus
  35.  
  36. compfls ..\*.lst 0 0 K A
  37.  
  38. called in c:\door\listen\afx will convert all *.lst file lists in
  39. c:\door\listen to .AFX file format without requiring you to do anything.
  40. The "A" parameters will make compfls only compile new file lists.
  41.  
  42.  
  43. ┌────────────────────────────────────────────────────────────────────────────┐
  44. │ Purpose of .AFX files, the first:                                          │
  45. └────────────────────────────────────────────────────────────────────────────┘
  46.  
  47. Adding a new file to ARV may take quite long if you let ARV search for
  48. the file's comments in text format files, like the well-known files.bbs
  49. style file lists. (If you don't know what I am talking about, see
  50. files_bbs option in ARV.DOK).
  51.  
  52. Adding a new file to ARV may be very fast if you let ARV search for the
  53. comment in an .AFX format file list. .AFX file lists are compiled
  54. file lists. The files desribed by an .AFX list are linked in lists
  55. in a very special way, allowing ARV to find any file in less that one
  56. second. compfls uses a table to represent lists of files with a
  57. same magic number, the "hashing table". The size of this table
  58. is given on compfls execution, or chosen by compfls. The bigger the
  59. table, the faster will the search be, but the bigger, the .AFX file
  60. list will get.
  61.  
  62. Please consult the files_bbs and afx_verz option descriptions in ARV.DOK
  63. on how to use .AFX files.
  64.  
  65. The big drawback of the .AFX file lists is that they are much longer
  66. than the original file lists. You will have to choose either speed
  67. or space...
  68.  
  69. Any AFX file may either contain:
  70.  
  71.   a) alle file names with comments only
  72.   b) the whole list content, i.e. a) plus all other lines not
  73.      describing files.
  74.  
  75. You will get a) by calling compfls without the K option.
  76. You will get b) by calling compfls with the K option.
  77.  
  78. The main difference is that the original file list may be contructed
  79. from the .AFX file list (by AFX2LST). Decompile a) type .AFX files will
  80. result in a list of file names with descriptions.
  81.  
  82. b) is especially of interest for FIDO-Net members:
  83.  
  84. ┌────────────────────────────────────────────────────────────────────────────┐
  85. │ Purpose of AFX files, the second                                           │
  86. └────────────────────────────────────────────────────────────────────────────┘
  87.  
  88. AFXREQ, a fast fido file request program uses .AFX files. See the
  89. Q & A section in ARV.DOK on where and how to get it. You won't need you
  90. plain text files anymore.
  91.  
  92.  
  93.